Upgrading

On this page:

Rollback

Rollback Instructions

This rollback guide will bring your system back to the previous version.

Note: Any data gained since the dump was taken will be lost. This includes jobs for any workflows that ran. It is possible, however, to restore that data by exporting the jobs and tasks collections separately and then reimporting them, but this is beyond the scope of this upgrade document.

Turn Off IAP

  1. SSH into all Pronghorn servers and perform the following to stop Pronghorn.

    sudo systemctl stop pronghorn

  2. Verify Pronghorn is stopped on all servers.

    ps -ef|grep Pronghorn

Export MongoDB (2020.1)

Execute a Mongo dump.

mongodump --host <MONGO HOSTNAME> --port=<MONGO PORT> --db=<PRONGHORN DB> --archive=<BACKUP LOC>/mongoDumpUpdated.bson

Example Output

mongoDump

Revert MongoDB to Previous State

Revert the instance of Mongo to the version saved in the Pre-Check backup instructions. Any new information since this time will be lost, including job and task data.

cd <BACKUP LOC>

mongorestore --drop --archive=./mongoDumpPreUpdate.bson --host <MONGO HOSTNAME> --port=<MONGO PORT>

Example Output

mongoRestore

  1. Change directory to the Pronghorn home directory.

    cd <PRONGHORN_HOME>

  2. Unlink current with the rm command. The name of this file will depend on the exact build you were on.

    rm ./current

  3. Create the new link.

    ln -s <IAP Previous Version> current

Restart IAP

  1. Restart IAP.

    sudo systemctl start pronghorn

  2. Verify pronghorn is stopped on all servers. For every IAP application running, there should be one process running.

    ps -ef | grep Pronghorn | grep -v grep

    Example Output

    Running Processes

  3. Login to verify the service is up. Use your login credentials to connect.

    verifyService


Return to Home Page

Troubleshooting